home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #2 / Ham Radio 2000 - Volume 2.iso / HAMV2 / SATELLIT / WISP1616 / WKCTDRV / README73.TXT < prev    next >
Text File  |  1997-11-18  |  18KB  |  360 lines
  1. ------------------------------------------------------------------------------
  2.     Windows Driver
  3.     for
  4.     Satellite Rotors and Radios
  5.     Version 0.73d beta
  6.     Dated June 5, 1995
  7.  
  8.     (C) Copyright 1994, 1995, David A. Hoatson, KC6WYG. All Rights Reserved.
  9.  
  10.     This software is provided as is.  No warranty is expressed or
  11.     implied.  By installing this software onto your system you 
  12.     agree to hold harmless David A. Hoatson for any for any damages 
  13.     whatsoever (including, without limitation, damages for loss of
  14.     profits, interruption of service, loss of information, lost savings,
  15.     other incidental or consequential damages or other pecuniary loss)
  16.     arising out of the use or inability to use this product, even if 
  17.     David A. Hoatson has been advised of the possibility of such damages.
  18.  
  19.     This software is written for the AMATEUR RADIO SATELLITE community
  20.     and may be distributed for NON-COMMERCIAL PURPOSES ONLY.  You are
  21.     granted a 30 day trial period to use this software.  If, after 30
  22.     days you continue to use this product, please send a donation of 
  23.     $10 to AMSAT.
  24. ------------------------------------------------------------------------------
  25.  
  26. Hello Satellite Users!
  27.  
  28. Thank you for using the Windows Driver for Satellite Rotors and Radios.  
  29. This release supports the Kansas City Tracker / Tuner from L.L. Grace and 
  30. the following radios:
  31.     Yaesu FT-736R
  32.     Kenwood TS-790, Kenwood TS-711, Kenwood TS-811
  33.     Icom IC-970, IC-820, Icom IC-275/IC-475, Icom IC-271/IC-471
  34.  
  35. Other radios will be supported in future editions.
  36.  
  37. I am not connected with L.L. Grace, Yaesu, Kenwood or Icom in anyway.
  38.  
  39. ***********************  INSTALLATION PROCEDURE  ***************************
  40.  
  41. Start with all of the files in a directory call \SATDRV.
  42.  
  43. We will start with the files that you must copy manually.  I have created 
  44. a file called INSTALL.BAT that will copy these two files for you if you wish.
  45.     SATELITE.DLL    in \WINDOWS\SYSTEM
  46.     KCTDRV.INI    in \WINDOWS
  47. PLEASE DO NOT MODIFY ANY OF THE PARAMETERS IN THE KCTDRV.INI FILE DIRECTLY!
  48. The driver has most error checking in place but you might change something 
  49. that doesn't have an error check and cause the system to crash!
  50.  
  51. The next two files should be in an install directory called \SATDRV.
  52.     KCTT.DRV    Control Panel Copies This For You
  53.     OEMSETUP.INF    Used for Installation Only
  54.  
  55. Now you must load the Control Panel in Windows.  
  56.     Double Click On "Drivers".
  57.     Click On "Add".
  58.     Double Click On "Unlisted or Updated" in the list box.
  59.     
  60.     The system will now prompt you for a drive and directory.  Type in
  61.     the drive that you started from (Probably C:) and the name of the
  62.     install directory (Probably \SATDRV).
  63.     
  64.     Another dialog box should come up with one item in it.  It should be
  65.     "Kansas City Tracker Driver For Windows".  Double Click On that item.
  66.  
  67.     Now the Drivers Setup dialog box should appear and you can configure
  68.     the driver.  All of the items are set to a default configuration 
  69.     (mine!) and should work if you have a similar setup.
  70.     
  71.     When you are done, press "OK".  Your driver installation is complete.
  72.     You may delete the directory \SATDRV if you created it during this 
  73.     installation process.
  74.  
  75. ***********************  UPDATE PROCEDURE  ***************************
  76.  
  77. If you have a previous version of the Windows Driver installed on your system,
  78. all you must do to update to the most current version is:
  79.  
  80. Exit Windows (Not just load a DOS Command Prompt!)
  81. From the C> prompt:
  82.     COPY SATELITE.DLL into the \WINDOWS\SYSTEM directory
  83.     COPY KCTT.DRV into the \WINDOWS\SYSTEM directory
  84.     COPY KCTDRV.INI into the \WINDOWS directory
  85.  
  86. You may now restart Windows and you driver has been updated.
  87.  
  88. There is a file called UPDATE.BAT that will copy the three files above for 
  89. you.
  90.  
  91.  
  92.                                ==================
  93.                                Installation Notes
  94.                                ==================
  95.  
  96. * Make sure that you have "Level 1" checked in your GSC "Rotator Setup" dialog
  97.   box.
  98.   
  99. * Flip Mode Tracking - The driver allows elevations of greater than 90 degrees
  100.   by default.  It is up to the application program to figure out that a 
  101.   particular satellite pass is going to go through 180 degrees azimuth and flip
  102.   the antenna over at the beginning of the pass.  NO PROTECTION from flipping
  103.   is provided in the driver.  This means that if your antenna cannot safely
  104.   flip over - the driver will not keep an application from setting a elevation
  105.   of greater than 90 degrees.  If you your antennas cannot safely flip over,
  106.   just specify 90 degrees as the maximum elevation during calibration.  This 
  107.   will keep the driver from setting a elevation of greater than 90 degrees.
  108.   Currently, WiSP (GSC V0.82x) does not allow for flip mode tracking, so this
  109.   is not an issue.
  110.  
  111. * The driver now supports calibration of the rotors.  Press the "Calibrate"
  112.   button on the KCT Driver Setup dialog box (from Control Panel, Setup) to 
  113.   enter the values for your rotor.  If you have a rotor that cannot go past
  114.   90 degrees elevation, you can now specify 90 degrees as the maximum
  115.   elevation.  The driver will not allow an application to move the rotor
  116.   beyond 90 degrees.  If you have a rotor that can go to 180 degrees, specify
  117.   that during calibration and the driver will allow the application to set
  118.   a elevation beyond 90 degrees.  (Hint: If you are a real technical person,
  119.   AND understand what you are doing, you can click on the "Cancel" button
  120.   while holding down the "Control" key on your keyboard.  This will cancel
  121.   the calibration questions and let you enter the eight values derived from
  122.   the questions directly. NO error checking of these values is provided, so
  123.   can easily set values that would cause a divide by zero error or 
  124.   worse.  If this happens, you will have to reload the default KCTDRV.INI
  125.   manually from DOS.)
  126.  
  127. * The driver now uses the Band information to determine which radio it is going
  128.   to send commands to.  You will need to setup the driver so the correct bands
  129.   are checked for the radio you have attached.  For example:  If you have a
  130.   Icom IC-275 / IC-475 you would check 144Mhz RX and 144Mhz TX for the IC-275
  131.   and 430Mhz RX and 430Mhz TX for the IC-475.  Then when the driver gets a
  132.   RadioSetFrequency command it will know which radio to send the information
  133.   to.  You may have the IC-275 / IC-475 on different ports or an the same port,
  134.   it doesn't matter to the driver.
  135.  
  136. * Dual Band Radios such as the IC-970, FT-736 and TS-790 must have the
  137.   main/sub bands set to the correct frequency band or the driver will not set 
  138.   the frequency correctly.  The driver does not read any information from the 
  139.   radio, so it cannot determine if the radio is in 144Mhz RX/430Mhz TX mode.
  140.   Therefore it cannot change the radio back to 430Mhz RX/144Mhz TX - so you
  141.   must do this manually.  This limitation will always exist for the FT-736, but
  142.   will be fixed for the other radios when the driver supports reading data 
  143.   back from the radio.
  144.   
  145. * If you have no radio and select "None" for all four radios in the setup 
  146.   dialog box, GSC V0.82x will produce a error dialog box upon AOS of a
  147.   satellite.  Some users have reported that this is followed by a general
  148.   protection fault with GSC.  If you encounter this, set your radio 1 to
  149.   "Yaesu FT-736R" on "Port A" and select 144Mhz and 430Mhz for both the
  150.   TX and RX bands.  The Yeasu radio selection never expects to get data back
  151.   from the radio so the driver will think that everything is tuning even
  152.   though there really isn't a radio connected.  Also, make sure that you
  153.   set your baud rate to 4800 or 9600.  This will keep the driver from spending
  154.   a lot of time waiting to send the data to a radio that isn't connected!
  155.  
  156. * Some older KCT boards had a layout error that changed the pins for the
  157.   rotor controls.  If you have to use the RIO option for the DOS TSR driver
  158.   to work, you have one of these boards.  This driver currently does not 
  159.   support these boards but will in the future.  (Hint: You can change the
  160.   wires in the DB25 connector going from the KCT to your rotor and that
  161.   will fix the problem as well).
  162.  
  163. * Several Users have tried to install the driver in the pre-release version
  164.   of Windows 95.  Please note that this is currently not a supported operating
  165.   system and will not install correctly.  A version of the driver that supports
  166.   Windows 95 is being developed and should be available soon.
  167.  
  168.                                 ================
  169.                                 Update / Changes
  170.                                 ================
  171.  
  172. Version 0.73f beta        August 7, 1997
  173. ----------------------------------------
  174. * Added correction for Azimuth calculation for situations where the
  175.   MinAzDec value is significantly greater than zero.
  176.  
  177.  
  178. Version 0.73e beta        March 17, 1997
  179. ----------------------------------------
  180. * Just added support for the IC-821 in the KCTDRV.INI file.
  181.  
  182.  
  183. Version 0.73d beta          June 4, 1995
  184. ----------------------------------------
  185. * Changed what the FT-736R gets for it's Open codes.  This fixes a problem
  186.   setting the mode on the FT-736R with WiSP.
  187.  
  188.  
  189. Version 0.73c beta        Never Released
  190. ----------------------------------------
  191. * Just added support for the IC-820 in the KCTDRV.INI file.
  192.  
  193.  
  194. Version 0.73b beta    September 18, 1994
  195. ----------------------------------------
  196. * Fixed bug with BRAKE control that caused the brake to be locked upon
  197.   azimuth motion and released when motion stopped.  Brake bit is now HIGH
  198.   when in motion and LOW when at rest.
  199.  
  200.  
  201. Version 0.73a beta    July 18, 1994
  202. -----------------------------------
  203. * Added Rotor Parking Feature.  The variables that control parking have been
  204.   added to the KCTDRV.INI file but are not brought out to any dialog box in
  205.   the setup screens as of yet.  If you want to change the parking values for
  206.   your rotor, you must edit the KCTDRV.INI file and then restart Windows to 
  207.   have the values take effect.  There are three values: ParkTime, ParkAzim and
  208.   ParkElev.  The ParkTime value is in seconds after the application closes
  209.   the rotor (LOS) and ParkAzim and ParkElev are in degrees.  ParkTime can
  210.   have a maximum of 65 seconds.  This keeps the rotor from moving to the
  211.   parking position if there is another satellite that is just about to come up.
  212. * Enabled the BRAKE control when moving the rotor.  The brake is released when
  213.   the azimuth rotor is started, and turned back on when the azimuth rotor is
  214.   stopped.
  215. * Disabled the rotor stop when at idle.  Previously the rotor would be sent a
  216.   "stop" command once a second just in case something were to start moving.
  217.   This would conflict with the DOS box if another program was trying to start
  218.   the rotor (Such as InstantTrack).  Now you can run a program in the DOS box
  219.   that controls the KCT as long as you don't have it running when a GSC pass
  220.   starts.  You also would load the TSR from the DOS box inside of Windows and
  221.   not before Windows starts.
  222.  
  223.  
  224. Version 0.72c beta    July 17, 1994
  225. -----------------------------------
  226. * Added preliminary support for the Kenwood TS-711 / TS-811.
  227. * Fixed a bug in the azimuth position reporting functions that would cause
  228.   a rotor with a minimum decimal azimuth value that was not zero to report
  229.   the wrong azimuth. (See 0.71a elevation bug notes below)
  230. * Increased the time-out values for the radio write byte routines to allow for
  231.   faster bus speeds.  The time-out value is bus speed specific, not processor
  232.   speed specific.
  233. * Added AzimDeadBandDec and ElevDeadBandDec to the KCTDRV.INI file.  These are
  234.   not brought out to any dialog box in the setup screens as of yet.  If you
  235.   want to change the deadband values for your rotor, you must edit the 
  236.   KCTDRV.INI file and then restart Windows to have the values take effect.
  237.   Please note that these values are decimal values, not degrees.  You can
  238.   convert from degrees to decimal with the following formula:
  239.  
  240.     DecimalValue = ((DegreeValue * TotalDecimalCount) / TotalDegrees)
  241.  
  242.   Where TotalDecimalCount is the Maximum A>D Decimal Position minus the Minimum
  243.   A>D Decimal Position (255-0 = 255) and TotalDegrees is the Total Number of 
  244.   degrees that the rotor can span. This is generally 360 for the azimuth and 
  245.   180 or 90 for the elevation.
  246.   
  247.   Generally increasing the DeadBand Values will make the rotor wait longer
  248.   before movement starts and keep the rotor running longer and decreasing 
  249.   the DeadBand Values will make the rotor start sooner and run for a shorter
  250.   period of time.  Smaller values will keep the rotor pointed at the target
  251.   more accurately where larger ones will have greater error, but run the rotors
  252.   less often.
  253.  
  254.  
  255. Version 0.72b beta    June 23, 1994
  256. -----------------------------------
  257. * Fixed bug that kept Kenwood TS-790 from working properly.
  258. * Changed the TS-790 macros to update the frequency correctly.
  259. * Verified TS-790 operation.
  260. * Removed the "Parser Error" message box.
  261.  
  262.  
  263. Version 0.72a beta     May 22, 1994
  264. -----------------------------------
  265. * FT-736R Macro changed to keep from going into Transmit Mode upon open.
  266. * IC-275/IC-475 Removed @CANCELDUPLEX command from open macros
  267. * The Elevation rotor now seeks to the correct position when the
  268.   calibration has the minimum position something other than 0.  This fixes
  269.   the problem of having a -90 / 0 / 90 degree rotor instead of a 0 / 90 / 180
  270.   degree one.
  271. * Some of the text for Calibration has been updated to be more accurate.
  272. * Added preliminary support for the Icom IC-271 / IC-471.
  273.  
  274.  
  275. Version 0.71a beta     May 17, 1994
  276. -----------------------------------
  277. * Driver now correctly handles elevation rotors that have a maximum of less
  278.   than 180 degrees.  Previously if you had a elevation rotor that could only
  279.   do 90 degrees, the driver would report half of the actual elevation.
  280. * After driver setup, Windows now must be restarted to reload the changed
  281.   parameters from the KCTDRV.INI file.
  282. * NumberOfRadios=4 has been changed to NumberOfRadios=6 in KCTDRV.INI
  283. * The Satellite Window (DEADBAND) has been decreased to 5 degrees azimuth 
  284.   and 3 degrees elevation to provide slightly better tracking.
  285.  
  286.  
  287. Version 0.70a beta     May 15, 1994
  288. -----------------------------------
  289. * Added calibrate rotor feature to setup dialog box.
  290. * Added support for up to four radios at once.
  291. * Added support for using Port B on the KCT/Tuner.
  292. * Added band support.  Please see installation notes above.
  293. * Added support for NFM and NCW.
  294. * Fixed a problem with SATELITE.DLL that would cause a error in RadioOpen
  295.   to leave the device opened instead of closed.  This caused a GP fault when
  296.   the application would try to close a device that wasn't really opened.
  297. * Changed the TS-790 macros to select the VFO A for each band on open.
  298. * Changed the IC-970 macros to cancel duplex for each band on open.
  299. * Added preliminary support for the Icom IC-275 / IC-475.
  300.  
  301.  
  302. Version 0.61b beta    May 6, 1994
  303. -----------------------------------
  304. * Fixed a problem with the stall code that would cause the driver to
  305.   think the rotor was stalled when in fact it was not.
  306.  
  307.  
  308. Version 0.61a beta    May 6, 1994
  309. -----------------------------------
  310. * Fixed the spelling of "Yeasu" to "Yaesu" in KCTDRV.INI again!
  311. * Fixed a problem with the "Invalid Command" message box that could cause
  312.   multiple message boxes to appear - and lock up the system.
  313. * SATELITE.DLL now changes negative elevations to zero.  This allows
  314.   GSC to position the azimuth correctly before the pass begins.  If the azimuth
  315.   is negative or greater than 360, ERR_INVALIDPARAM is returned.
  316. * Added Stall Function to rotor.  If the rotor doesn't move for two seconds
  317.   the driver will shut that rotor off and wait 15 seconds.  If another
  318.   RotorSetPosition command is issued during the 15 second timeout, the rotor
  319.   will not be restarted.  After 15 seconds has elapsed the RotorSetPosition 
  320.   command will restart the rotor and the cycle will be reset.  The driver now 
  321.   returns two additional error codes, STATUS_AZIMSTALLED (0x2000) and 
  322.   STATUS_ELEVSTALLED (0x1000).  If both rotors are stalled the error code
  323.   would be 0x3000.
  324. * When the rotor device is closed by the application with ACCESS_READWRITE
  325.   all motion is now stopped.
  326. * Rotor functions now are much smoother.  The Satellite Window (DEADBAND) has 
  327.   been increased to 6 degrees azimuth and 4 degrees elevation.
  328. * Satellite Monitor program now included with driver.  This program will 
  329.   display the current status of the rotor and radio.  No controls are provided.
  330. * MAKE SURE YOU READ "INSTALLATION NOTES" ABOVE FOR ROTOR SETUP INFORMATION!
  331.  
  332.  
  333. Version 0.60a beta    May 3, 1994
  334. -----------------------------------
  335. * Added preliminary support for the Kenwood TS-790
  336. * Added preliminary support for the Icom IC-970
  337. * YOU MUST USE THE KCTDRV.INI file that came with this driver for your radio
  338.   to work correctly.
  339.  
  340.  
  341. Version 0.51a beta    May 3, 1994
  342. -----------------------------------
  343. * Fixed a problem with the rotor positioning that caused any azimuth over
  344.   75 degrees to subtract 180 degrees!  This would result in the antenna 
  345.   pointing in the wrong direction for most of a pass!
  346. * Made SATELITE.DLL standalone.  This means that if you don't have a KCT/T
  347.   you can use SATELITE.DLL with WiSP and not generate error messages.  You
  348.   should not install the KCT/T driver. (i.e. no Radio= or Rotor= in SYSTEM.INI
  349.   [Drivers] section).
  350. * Fixed the spelling of "Yeasu" to "Yaesu" in KCTDRV.INI.
  351. * Made the selection of "None" as the radio name not generate "Parser Errors".
  352.  
  353.  
  354. Version 0.50a beta    Apr 27, 1994
  355. ------------------------------------
  356. * First Release for ZL2TPO only
  357.  
  358. -END-
  359.  
  360.